home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / dosdir21.zip / README < prev    next >
Text File  |  1994-06-24  |  3KB  |  57 lines
  1.                 DOSDIR: A Portable DOS/UNIX/VMS Directory Interface
  2.                 version 2.1
  3.                 -----------------------------------------------
  4.  
  5. DOSDIR is an implementation of the MS-DOS directory functions (findfirst,
  6. findnext, and fnsplit) on MS-DOS, UNIX, and VMS platforms using the
  7. appropriate file & directory structure.
  8.  
  9. It uses the DOS directory framework to provide a portable interface
  10. for MS-DOS/UNIX/VMS application programmers.  DOSDIR minimizes the OS-
  11. specific directory access code for applications allowing programmers to
  12. concentrate on the application itself and not on the low-level directory
  13. and file structure.  DOSDIR applications will run on their native operating
  14. systems with the appropriate file syntax and handling, which is expected
  15. for that platform.
  16.  
  17. An alternative mechanism, the POSIX opendir/readdir directory functions,
  18. provides low-level directory access with all of the file handling in
  19. the application.  Findfirst/findnext filter files matching a filemask
  20. and returns file information, such as whether the entry is directory or a
  21. regular file or the entry is read-only.  However, readdir() returns only the
  22. filenames of files in the opened directory stream.
  23.  
  24. The package includes the following files:
  25.  
  26.     dosdir.c      - DOSDIR findfirst/findnext functions
  27.         dirent.c      - C/C++ Run Time Library opendir/readdir functions
  28.     fnsplit.c     - C/C++ Run Time Library fnsplit function
  29.     match.c       - Info-ZIP regular expression evaluator
  30.         *.h           - DOSDIR header files
  31.     filelist.c    - Example program using dosdir directory functions
  32.     example2.c    - Another example program
  33.         example3.c    - An example program for opendir functions
  34.     makefile.bor  - Makefile for MS-DOS with Borland C++
  35.     makefile.unx  - Makefile for UNIX with gcc
  36.     vaxmake.com   - Script to compile examples for VAX/VMS
  37.  
  38. DOSDIR supports and has been tested under the following systems:
  39. MS-DOS 3.3/5.0 with Borland C++ V3.x/4.0, Turbo C, or Microsoft C V6.0/7.0,
  40. SunOS 4.1 with SUN or GNU C compilers, SGI IRIX 4.05, DEC Alpha OSF/1, and
  41. VMS 5.5 with VAX C.  Other comparable ANSI C compilers should work as well.
  42.  
  43.         Jason Mathews
  44.         NASA/Goddard Space Flight Center
  45.         Code 633.2
  46.         Greenbelt, Maryland  20771-0001 USA
  47.  
  48.     Internet: mathews@nssdca.gsfc.nasa.gov
  49.  
  50.   ---------------------------------------------------------------------------
  51.  
  52. Copyright (C) 1994 Jason Mathews.
  53.  
  54. Permission is granted to any individual or institution to use, copy
  55. or redistribute this software so long as it is not sold for profit,
  56. provided this copyright notice is retained.
  57.